Node / meshtastic / Meshtastic-Android / files / core / data / src / jvmTest / kotlin / org / meshtastic / core / data / util / SingleFlightRefresherTest.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.core.data.util

Tff7b72import T7ee787kotlinx.coroutines.CompletableDeferred

Tff7b72import T7ee787kotlinx.coroutines.Dispatchers

Tff7b72import T7ee787kotlinx.coroutines.launch

Tff7b72import T7ee787kotlinx.coroutines.runBlocking

Tff7b72import T7ee787kotlinx.coroutines.withTimeout

Tff7b72import T7ee787kotlinx.coroutines.yield

Tff7b72import T7ee787kotlin.test.Test

Tff7b72import T7ee787kotlin.test.assertEquals

Tff7b72import T7ee787kotlin.test.assertFalse

T8b949e// Real dispatchers + runBlocking, NOT runTest — the refresher's detached scope must interleave with the

T8b949e// callers on real coroutine semantics, and Unconfined keeps the interleaving deterministic.

Tff7b72class T56d364SingleFlightRefresherTest Tb4b4b4{

Tff7b72private Tff7b72class T56d364GatedWork Tb4b4b4{

Tff7b72val Te6edf3gate Tff7b72= Te6edf3CompletableDeferredTff7b72<Tffa657UnitTff7b72>Tb4b4b4(Tb4b4b4)

Tff7b72var Te6edf3starts Tff7b72= T79c0ff0

Tff7b72var Te6edf3completions Tff7b72= T79c0ff0

Tff7b72suspend Tff7b72fun Td2a8ffrunTb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3startsTff7b72+Tff7b72+

Te6edf3gateTb4b4b4.Te6edf3awaitTb4b4b4(Tb4b4b4)

Te6edf3completionsTff7b72+Tff7b72+

Tb4b4b4}

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ffconcurrentCallersShareOneFlightTb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runBlocking Tb4b4b4{

Tff7b72val Te6edf3work Tff7b72= Te6edf3GatedWorkTb4b4b4(Tb4b4b4)

Tff7b72val Te6edf3refresher Tff7b72= Te6edf3SingleFlightRefresherTb4b4b4(Te6edf3DispatchersTb4b4b4.Te6edf3UnconfinedTb4b4b4, Ta5d6ff"Ta5d6fftestTa5d6ff"Tb4b4b4) Tb4b4b4{ Te6edf3workTb4b4b4.Te6edf3runTb4b4b4(Tb4b4b4) Tb4b4b4}

Tff7b72val Te6edf3first Tff7b72= Te6edf3launch Tb4b4b4{ Te6edf3refresherTb4b4b4.Te6edf3refreshTb4b4b4(Tb4b4b4) Tb4b4b4}

Tff7b72val Te6edf3second Tff7b72= Te6edf3launch Tb4b4b4{ Te6edf3refresherTb4b4b4.Te6edf3refreshTb4b4b4(Tb4b4b4) Tb4b4b4}

Te6edf3withTimeoutTb4b4b4(T79c0ff2Te6edf3_000Tb4b4b4) Tb4b4b4{ Tff7b72while Tb4b4b4(Te6edf3workTb4b4b4.Te6edf3starts Tff7b72=Tff7b72= T79c0ff0Tb4b4b4) Te6edf3yieldTb4b4b4(Tb4b4b4) Tb4b4b4}

Te6edf3workTb4b4b4.Te6edf3gateTb4b4b4.Te6edf3completeTb4b4b4(Tffa657UnitTb4b4b4)

Te6edf3firstTb4b4b4.Te6edf3joinTb4b4b4(Tb4b4b4)

Te6edf3secondTb4b4b4.Te6edf3joinTb4b4b4(Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(T79c0ff1Tb4b4b4, Te6edf3workTb4b4b4.Te6edf3startsTb4b4b4, Ta5d6ff"Ta5d6ffsecond caller joins the in-flight refresh instead of starting its ownTa5d6ff"Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(T79c0ff1Tb4b4b4, Te6edf3workTb4b4b4.Te6edf3completionsTb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8fftimedOutCallerFallsBackWhileRefreshRunsToCompletionTb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runBlocking Tb4b4b4{

Tff7b72val Te6edf3work Tff7b72= Te6edf3GatedWorkTb4b4b4(Tb4b4b4)

Tff7b72val Te6edf3refresher Tff7b72= Te6edf3SingleFlightRefresherTb4b4b4(Te6edf3DispatchersTb4b4b4.Te6edf3UnconfinedTb4b4b4, Ta5d6ff"Ta5d6fftestTa5d6ff"Tb4b4b4) Tb4b4b4{ Te6edf3workTb4b4b4.Te6edf3runTb4b4b4(Tb4b4b4) Tb4b4b4}

Te6edf3refresherTb4b4b4.Te6edf3refreshTb4b4b4(Te6edf3maxWaitMs Tff7b72= T79c0ff5T79c0ff0Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(T79c0ff1Tb4b4b4, Te6edf3workTb4b4b4.Te6edf3startsTb4b4b4)

Te6edf3assertFalseTb4b4b4(Te6edf3workTb4b4b4.Te6edf3completions Tff7b72> T79c0ff0Tb4b4b4, Ta5d6ff"Ta5d6ffcaller returned before the refresh finishedTa5d6ff"Tb4b4b4)

Te6edf3workTb4b4b4.Te6edf3gateTb4b4b4.Te6edf3completeTb4b4b4(Tffa657UnitTb4b4b4)

Te6edf3withTimeoutTb4b4b4(T79c0ff2Te6edf3_000Tb4b4b4) Tb4b4b4{ Tff7b72while Tb4b4b4(Te6edf3workTb4b4b4.Te6edf3completions Tff7b72=Tff7b72= T79c0ff0Tb4b4b4) Te6edf3yieldTb4b4b4(Tb4b4b4) Tb4b4b4}

Te6edf3assertEqualsTb4b4b4(T79c0ff1Tb4b4b4, Te6edf3workTb4b4b4.Te6edf3completionsTb4b4b4, Ta5d6ff"Ta5d6ffthe refresh ran to completion after the caller stopped waitingTa5d6ff"Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ffcallerCancellationDoesNotAbortTheSharedRefreshTb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runBlocking Tb4b4b4{

Tff7b72val Te6edf3work Tff7b72= Te6edf3GatedWorkTb4b4b4(Tb4b4b4)

Tff7b72val Te6edf3refresher Tff7b72= Te6edf3SingleFlightRefresherTb4b4b4(Te6edf3DispatchersTb4b4b4.Te6edf3UnconfinedTb4b4b4, Ta5d6ff"Ta5d6fftestTa5d6ff"Tb4b4b4) Tb4b4b4{ Te6edf3workTb4b4b4.Te6edf3runTb4b4b4(Tb4b4b4) Tb4b4b4}

Tff7b72val Te6edf3caller Tff7b72= Te6edf3launch Tb4b4b4{ Te6edf3refresherTb4b4b4.Te6edf3refreshTb4b4b4(Tb4b4b4) Tb4b4b4}

Te6edf3withTimeoutTb4b4b4(T79c0ff2Te6edf3_000Tb4b4b4) Tb4b4b4{ Tff7b72while Tb4b4b4(Te6edf3workTb4b4b4.Te6edf3starts Tff7b72=Tff7b72= T79c0ff0Tb4b4b4) Te6edf3yieldTb4b4b4(Tb4b4b4) Tb4b4b4}

Te6edf3callerTb4b4b4.Te6edf3cancelTb4b4b4(Tb4b4b4)

Te6edf3callerTb4b4b4.Te6edf3joinTb4b4b4(Tb4b4b4)

Te6edf3workTb4b4b4.Te6edf3gateTb4b4b4.Te6edf3completeTb4b4b4(Tffa657UnitTb4b4b4)

Te6edf3withTimeoutTb4b4b4(T79c0ff2Te6edf3_000Tb4b4b4) Tb4b4b4{ Tff7b72while Tb4b4b4(Te6edf3workTb4b4b4.Te6edf3completions Tff7b72=Tff7b72= T79c0ff0Tb4b4b4) Te6edf3yieldTb4b4b4(Tb4b4b4) Tb4b4b4}

Te6edf3assertEqualsTb4b4b4(T79c0ff1Tb4b4b4, Te6edf3workTb4b4b4.Te6edf3completionsTb4b4b4, Ta5d6ff"Ta5d6ffthe detached refresh survives its caller's cancellationTa5d6ff"Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8fffailureIsContainedAndTheNextRefreshStartsANewFlightTb4b4b4(Tb4b4b4) Tff7b72= Te6edf3runBlocking Tb4b4b4{

Tff7b72var Te6edf3attempts Tff7b72= T79c0ff0

Tff7b72val Te6edf3refresher Tff7b72=

Te6edf3SingleFlightRefresherTb4b4b4(Te6edf3DispatchersTb4b4b4.Te6edf3UnconfinedTb4b4b4, Ta5d6ff"Ta5d6fftestTa5d6ff"Tb4b4b4) Tb4b4b4{

Te6edf3attemptsTff7b72+Tff7b72+

Tff7b72if Tb4b4b4(Te6edf3attempts Tff7b72=Tff7b72= T79c0ff1Tb4b4b4) Te6edf3errorTb4b4b4(Ta5d6ff"Ta5d6ffnetwork downTa5d6ff"Tb4b4b4)

Tb4b4b4}

Te6edf3refresherTb4b4b4.Te6edf3refreshTb4b4b4(Tb4b4b4) T8b949e// must not throw

Te6edf3refresherTb4b4b4.Te6edf3refreshTb4b4b4(Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(T79c0ff2Tb4b4b4, Te6edf3attemptsTb4b4b4, Ta5d6ff"Ta5d6ffa failed flight is not reused; the next caller starts a fresh oneTa5d6ff"Tb4b4b4)

Tb4b4b4}

Tb4b4b4}